7.1.1 建立MINPAY錢包支付訂單

#簡要描述： MINPAY錢包掃碼人民幣充值業務接口，用戶透過掃描二維碼來完成充值 CNY 到他們的錢包帳戶

• 要求方式: POST
• 請求介面: https://网关域名/wallet-trade-merchant/v1/receive/internal/api/create
• 請求媒體類型( JSON 資料格式 )Content-Type: application/json

請求參數

參數名稱	類型	必填	參數意義	參數說明
key	string	是	商家 key	apiKey
localOrderId	string	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
localUserId	string	否	商家平臺本機使用者ID	商家平臺本機使用者ID
amount	number	是	收款金額	訂單金額
notifyUrl	string	是	回呼位址	下單成功後，由 API 回呼通知商家的位址 | (回調詳情參考文件3)
successRedirectUrl	string	否	位址	成功後自動跳轉位址
currency	string	是	訂單幣種	訂單幣種(錢包支持幣種)
expireSecond	Long	否	過期時間戳記（秒）
sign	string	是	簽章	詳情請見簽章演算法

請求 json 範例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "173322",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 1,
  "currency": "USDT",
  "sign": "7f07092874886179997617567a98e20e"
}

回應 json 範例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": "273719658252609",
    "localUserId": null,
    "localOrderId": "173322",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/scan-pay/JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke",
    "publicKey": "JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke"
  }
}

返回的 paymentUrl 彈出付款頁面，如下圖：


回應data 參數說明

參數名稱	類型	參數意義	參數說明
orderId	string	訂單 ID
localUserId	string	商家號碼
localOrderId	string	商家本地訂單號碼
orderType	enum	訂單類型	PAYMENT:支付订单 ｜ WITHDRA:提款订单
orderBizType	enum	訂單業務	orderBizType 類型說明如下
paymentUrl	string	位址	付款位址
publicKey	string	秘鑰	公共存取金鑰

orderBizType 類型說明：

1、PAYMENT_WALLET_SCAN MINPAY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至MINPAY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付

回呼返回 json 資料

預設所有回呼參數參與驗簽，回呼參數詳情請看回呼

回呼 data

{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT"
}

當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。 系統在收到 success 回應後，將不再對該筆回呼進行重複發送。 若未收到期望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。 當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s